Use the Double Click trigger to react to the double-click gesture. For example, you can change the appearance of a node when the user double-clicks or double-taps that node. See Using the Double Click trigger.
The multi-click manipulator is one of the input manipulators you can use to add gesture recognition to nodes in your Kanzi application. You can assign the input manipulators through the Kanzi Engine API. See Using input manipulators.
In Kanzi Studio create a project using the Application template.
In the Project create a node for which you want to enable the double-click gesture. For example, create an Empty Node 2D node, name it DoubleClickNode, and add content to the node.
In the Project select the node you created in the previous step, in the Properties add the Hit Testable property, and set it to enabled. When you enable this property you enable the user to pick a node.
In the Projectpress Alt and right-click the node you created and select Alias. Kanzi Studio creates an alias pointing to the node from which you created the alias and adds it to the resource dictionary of its nearest ancestor node that contains a resource dictionary. Access alias target nodes using the # sign followed by the name of the alias.
Select File > Export > Export KZB. Kanzi Studio creates the kzb file and configuration files from your Kanzi Studio project. Kanzi Studio stores the exported files in <KanziWorkspace>/Projects/<ProjectName>/Application/bin or the location you specify in the Binary Export Directory property in Project > Properties. The kzb file contains all nodes and resources from your Kanzi Studio project, except the resources you mark in a localization table as locale packs. When you run your Kanzi application from Visual Studio, your Visual Studio solution reads these files to create your Kanzi application.
In Visual Studio open the solution stored in <ProjectName>/Application/configs/platforms/win32 and in the file which implements the logic of your application create and configure the multi-click manipulator:
Create the handler for the multi-click message. For example, after the public section of the class which implements the logic of your application add:
private:
// Create the handler for the MultiClickManipulator::MultiClickMessage message from the nodes
// that have an input manipulator which generates the multi-click message.
void onNodeDoubleClicked(MultiClickManipulator::MultiClickMessageArguments& messageArguments)
{
// Add the code that handles the double-click event.
}
In the onProjectLoaded() function create a MultiClickManipulator manipulator and subscribe to its message. For example, add:
virtual void onProjectLoaded() KZ_OVERRIDE
{
ScreenSharedPtr screen = getScreen();
Domain* domain = getDomain();
// Get the DoubleClickNode node using its alias.
NodeSharedPtr doubleClickNode = screen->lookupNode<Node>("#DoubleClickNode");
// Create an input manipulator that generates double-click messages.
MultiClickManipulatorSharedPtr multiClickManipulator = MultiClickManipulator::create(domain);
// Add the input manipulator to the DoubleClickNode node.
doubleClickNode->addInputManipulator(multiClickManipulator);
// Set the timeout of the double-click to 500 ms. The default timeout is 250 ms.
// If two clicks occur within this time, the input manipulator recognizes them
// as a double-click gesture.
multiClickManipulator->setTimeout(chrono::milliseconds(500));
// Subscribe to the MultiClickManipulator::MultiClickMessage message at the DoubleClickNode node.
// The MultiClickManipulator manipulator generates this message when the user double-clicks the node.
doubleClickNode->addMessageHandler(MultiClickManipulator::MultiClickMessage, bind(&MyProject::onNodeDoubleClicked, this, placeholders::_1));
}
Build and run your application. See Deploying Kanzi applications. In the application double-click or double-tap the node for which you enabled the double-click gesture. The application executes the behavior you defined in the handler for the MultiClickMessage message.
Using the Double Click trigger
Use the Double Click trigger to react to the double-click gesture. For example, you can change the appearance of a node when the user double-clicks or double-taps that node.
Define the behavior that you want to set with the Double Click trigger. For example, create a state manager where you define the states which set the appearance of a node when the Double Click trigger is set off repeatedly. See Adding a state manager to your project.
In the Project select the node to which you want to add the trigger, and in the Node Components > Triggers section add the Double Click trigger.
In the trigger you created in the previous step click Trigger Settings and in the Trigger Settings Editor disable the Set Message Handled property. When you disable the Set Message Handled property, this trigger intercepts the message, but does not stop it. This way you let the input manipulator handle the message.
In the trigger you created, in the Add dropdown menu select an action and configure it. For example, select the Next State action, and in the action settings set:
Target Item to the node which uses the state manager you created to set the appearance of a node when the Double Click trigger is set off repeatedly
State Group to the state group which contains the states between which you want to switch when the Double Click trigger is set off
Select File > Export > Export KZB.
Build and run your application. See Deploying Kanzi applications. In the application double-click or double-tap the node for which you enabled the double-click gesture.
